package com.turbo.cloud.minio.web.service;

import com.amazonaws.services.s3.model.S3Object;
import com.turbo.cloud.minio.web.entity.MinioFile;
import io.minio.messages.Bucket;
import io.minio.messages.Item;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * Minio文件处理服务类
 *
 * @author zhangluning
 */
public interface IMinioFileService {
    /**
     * 查看存储bucket是否存在
     *
     * @param bucketName 桶名
     * @return boolean
     */
    Boolean bucketExists(String bucketName);

    /**
     * 创建存储bucket
     *
     * @param bucketName 桶名
     * @return Boolean
     */
    Boolean makeBucket(String bucketName);

    /**
     * 删除存储bucket
     *
     * @param bucketName 桶名
     * @return Boolean
     */
    Boolean removeBucket(String bucketName);

    /**
     * 获取全部bucket
     */
    List<Bucket> getAllBuckets();

    /**
     * 文件上传
     *
     * @param file       文件
     * @param bucketName 桶名
     * @return Boolean
     */
    MinioFile upload(MultipartFile file, String bucketName, String businessType, String businessNo, String uploadBy);

    /**
     * 文件上传
     *
     * @param file         文件
     * @param bucketName   桶名
     * @return Boolean
     */
    MinioFile uploadByAuth(MultipartFile file, String bucketName);


    /**
     * 预览文件链接
     *
     * @param fileId     文件ID
     * @param bucketName 桶名
     * @return
     */
    String getFileUrl(String fileId, String bucketName);

    /**
     * 预览文件链接（失效时间）
     *
     * @param fileId     文件编码
     * @param bucketName 桶名
     * @param expiry     失效时间（秒）
     * @return
     */
    String getExpiryFileUrl(String fileId, String bucketName, int expiry);

    /**
     * 文件下载
     *
     * @param response   response
     * @param fileId     文件编码
     * @param bucketName 桶名
     * @return Boolean
     */
    void download(HttpServletResponse response, String fileId, String bucketName);

    /**
     * 查看文件对象
     *
     * @param bucketName 桶名
     * @return 存储bucket内文件对象信息
     */
    List<Item> listObjects(String bucketName);

    /**
     * 删除
     *
     * @param fileId
     * @param bucketName 桶名
     * @return
     * @throws Exception
     */
    boolean remove(String fileId, String bucketName);

    /**
     * 通过bucketName和objectName获取对象
     *
     * @param fileId
     * @param bucketName 桶名
     * @return
     */
    S3Object getObject(String fileId, String bucketName);
}
